Les « tags »

Dans la documentation, les tags (liens normalement situés au-dessus du trait en haut de page (lui même situé au-dessus du titre de la page)) permettent de créer des liens entre toutes les pages facilement. Comme l'explique cette section, toutes les pages contenant un même tag peuvent être listées très facilement afin de voir quelle pages parlent de tel ou tel sujet. Les tags sont en quelque sorte utilisés pour catégoriser une page.

Pour que les tags fonctionnent correctement, veillez à respecter les quelques règles qui suivent.

Pour utiliser des tags (mots-clés) dans les pages du wiki :

{{tag>liste des tags}}

Les tags de cette liste des tags sont séparés par des espaces. Pour inclure une espace dans le nom du tag, remplacez-la par un tiret bas. Vous pouvez voir une liste des tags utilisés dans la documentation sur la page catégories.

• Un tag doit correspondre à une page existante, ainsi lorsqu'on clique sur le tag, on est redirigé vers cette page
• Choisissez vos tags parmi les tags existants
• Ne pas créer un nouveau tag s'il ne peut être placé sur 5 pages ou plus : voir Suppression de Tags
• S'il y a des espaces, ils sont matérialisés par un tiret bas « _ ».
• Les tags doivent être au singulier.
• Les tags devant être accentués le sont. Exemples : matériel, système, sécurité, etc.

{{tag>matériel système sécurité}}

• Les tags doivent être intégralement écrits en minuscule. Quelques exceptions : le tag BROUILLON doit être écrit en majuscules afin qu'il soit visible, les tags des versions d'Ubuntu peuvent prendre une majuscule.

• Les tags des versions d'Ubuntu (Dapper, Hardy, Karmic, Lucid, Maverick, …) correspondent aux versions pour lesquelles la page est valide; ils sont utiles pour toutes les pages de la documentation sauf les portails. On utilise uniquement l'adjectif du nom de code de la version. Plus d'informations à ce sujet.

• Les tags doivent suivre l'ordre suivant :

{{tag><Versions d'Ubuntu> <domaine_principal> <domaines spécifiques> <autres_tags> <tutoriel si c'est un tutoriel ou autre> BROUILLON}}

• On fait suivre la liste des tags d'un trait pour bien séparer du texte grâce à la syntaxe :

----

Ce qui donne

Pour le fonctionnement interne de la documentation certains tags peuvent être placés sur des pages spécifiques afin d'attirer l'attention.

Ces tags sont :

• BROUILLON : ce tag indique que la page doit être relue, est en cours de rédaction ou doit être améliorée
• vétuste : pour les pages n'ayant pas d'informations récentes et n'ayant pas été validées pour une version encore supportée,
• a_recycler : pour les pages qui peuvent être intéressante dans leur contenus mais qui doivent être intégrée à d'autres pages,
• à_supprimer : pour les pages que l'ont pense supprimer mais auxquelles ont attend une éventuelle ré-écriture.

Pour lister les pages ayant un tag particulier utilisez cette syntaxe :

{{topic>nom_du_tag}}

Si vous venez d'ajouter un tag à une page et qu'une page listant les pages contenant ce tag via « le wikicode topic » ne contient pas votre page, cela est peut-être dû au fait que votre page ne contient pas de titre de niveau 1. Veillez à bien structurer votre page de manière sémantique (c'est-à-dire avec des titres, etc.).

D'autres syntaxes sont également possibles :

{{topic>tag1 +tag2}}           (tag1 ET tag2)
{{topic>tag1 -tag2}}           (tag1 SAUF tag2)
{{topic>tag1 tag2}}            (tag1 OU tag2)

Pour plus de détails, se référer à l'aide de l'élément Topic sur DokuWiki.

Pour afficher les tags utilisés sur la documentation, utilisez cette syntaxe :

~~TAGCLOUD:number~~

Remplacer number par le nombre de tag que vous voulez afficher (compris entre 1 et 999). Si vous ne préciser pas number (ou que vous le laisser), 50 tags sont affichés.

La page catégories utilise cette syntaxe.

Les balises topics, précédemment présentées ne fonctionnent pas toujours correctement, sans que la cause soit bien déterminée. Ce problème fait l'objet du rapport de bogue suivant.

Ce problème a également lieu quand on recherche toutes les pages contenant un certain tag, comme c'est le cas dans beaucoup de liens de la page sur la suppression des tags trop peu utilisés.

Pour savoir si ce bogue a lieu en ce moment, le lien suivant devrait vous donner bien plus que 5 résultats (tag maverick).

• Le système de tag est un plugin de Dokuwiki : plus d'infos sur ce plugin ici
• Le nuage de tag est un plugin distinct du pugin tag : plus d'infos sur ce plugin ici